home *** CD-ROM | disk | FTP | other *** search
/ EnigmA Amiga Run 1999 March / EnigmA AMIGA RUN 35 (1999)(G.R. Edizioni)(IT)[!][issue 1999-03].iso / earcd / -archivi / -recent3 / uae-app_012.readme < prev    next >
Text File  |  1999-01-01  |  7KB  |  146 lines
  1. Short:    UAE-ADF Mount+Unmount Workbench-Interface
  2. Author:   hippie@cheerful.com  [ Ralf Steines aka Hippie2000 ]
  3. Uploader: hippie@cheerful.com  [ Ralf Steines aka Hippie2000 ]
  4. Type:     misc/emu
  5.  
  6. $VER: UAE-App 0.1.2 by Hippie2000
  7.  
  8.  
  9. UAE-ADF Mount+Unmount Workbench-Interface
  10.  
  11.  
  12. Introduction
  13.  
  14.      UAE-App is a Commodity integrating the DF0: - DF3: ADF disk emulation control of UAE in the
  15.      Amiga-OS. It provides the entire scale of Amiga User-Interfaces, such as Shell / Workbench /
  16.      AppIcon / AppWindow / AppMenuItem / PopupGUI / Commodity to make ADF disk emulation
  17.      handling as simple as possible.
  18.  
  19. Requirements
  20.  
  21.      UAE-App is a single 40K executable (and its icon), designed to be placed in the wbstartup folder of
  22.      your UAE-emulated V37+ workbench. It does not require any special libraries, just those which are
  23.      part of the AmigaOS. It should work with all UAE ports which allow to mount parts of the native
  24.      host-filesystem as amiga volumes.
  25.  
  26. Download
  27.  
  28.      Check http://metamonk.com/uae/ for online doc and newest version!
  29.  
  30. Installation
  31.  
  32.      1) Decide where you want to store all your ADF images. This may either be an already mounted
  33.      native-filesystem harddisk emulation or a new volume just for this purpose. If you decide to use a new
  34.      volume (eg ADF:) use the UAE-GUI or UAE commandline-arguments to mount it and put all yor
  35.      ADFs there. Start UAE and check if the new volume appears on your workbench.
  36.  
  37.      2) Unpack the UAE-App archive in a temporary folder and drag the UAE-App application in your
  38.      wbstartup folder. Do not start it before you have finished configuration.
  39.  
  40.      3) Currently all amiga-side configurations are done by modifying the following 3 workbench tooltypes
  41.      of sys:wbstartup/uae-app.info.
  42.  
  43.      HOST-PATH=D:\amiga\adfopus\disks\
  44.      AMIGA-PATH=ADF:
  45.      HOST-SLASH=\
  46.  
  47.      The tooltype "HOST-PATH" must be set to the native path in your host filesystem which you have
  48.      choosen in step (1) to keep all your ADF images. MUST END WITH A DELIMITER! (dosish: "\" or
  49.      ":\" and unixish: "/" or ":"). "AMIGA-PATH" must point at exactly the same location as defined in
  50.      tooltype HOST-PATH, but seen from the amiga side. "HOST-SLASH" must be the slash character
  51.      used by the host filesystem to divide directorynames from filenames in pathes. (dosish: "\" and unixish:
  52.      "/"). Mounting of ADF images will be limited to the both pathes above, what may be useful to avoid
  53.      mounting files which end in ".adf" and are no amiga disk files (eg adobe uses this file extension too)
  54.  
  55.      4) "Reboot" your emulation and have fun!
  56.  
  57. Usage
  58.  
  59.      GUI POPUP WINDOW
  60.  
  61.      UAE-App normally hides its GUI until you call the ADF disk insertion function by one of the interfaces
  62.      described below. The GUI will pop up, showing you the path of the ADF image you want to insert,
  63.      enabling the buttons "Insert 0" to "Insert 3". Click one of them and the virtual disk will be inserted in the
  64.      appropriate drive. Or click "Ignore", and the last insertion event will be ignored. ADF disk insertion is
  65.      limited to ".adf" images within the path specified in the AMIGA-PATH tooltype (case insensitive).
  66.      Anything else you may attemp to insert will just flash your workbench screen.
  67.  
  68.      APP INTERFACE (DRAG AND DROP )
  69.  
  70.      UAE-App enables the complete Workbench App-Interface to trigger ADF disk insertion and removal
  71.      operations. Dragging an ADF image file in the Workench-App-Icon or the Popup-GUI or activating
  72.      the file and using the App-MenuItem will call the disk insertion function (ADF file does not need to
  73.      have an icon for this). Dragging a disk icon associated with a DFx: virtual floppy drive in the
  74.      Workench-App-Icon or the Popup-GUI or activating it and using the App-MenuItem will call the disk
  75.      removal function in turn.
  76.  
  77.      DEFAULT TOOL INTERFACE
  78.  
  79.      You may create Project Icons for your ADF image files, pointing at sys:wbstartup/uae-app as default
  80.      tool. This will enable you to insert ADF images by double-clicking at them, and will be the future
  81.      interface to store UAE settings in the workbench tooltypes of each ADF image. (TODO)
  82.  
  83.      SHELL INTERFACE
  84.  
  85.      sys:wbstartup/uae-app <filename.adf> may be called from shell to insert the named disk image. This
  86.      may be useful in scripts or to integrate UAE-App functions in other programs, such as DOPUS or
  87.      Toolmanager. Note that this call is asynchronous and does not wait for the disk insertion to be
  88.      completed (yet?).
  89.  
  90.      SHUTTING DOWN UAE-APP
  91.  
  92.      Yo do not want to do this, do you? OK! Use Commodities Exchange, use 'Quit' in the GUI's 'Project'
  93.      menu to shut down the server. This will disable all functionality of UAE-App, even the shell interface
  94.      and the default tool interface. Relaunch UAE-App from workbench to enable all features again.
  95.  
  96. Technical info
  97.  
  98.      UAE-App is a hybrid single executable solution. The first instance is launched as a (unique) commodity
  99.      from your wbstartup. It acts as a message server to handle the GUI, the AppInterface and a remote
  100.      event dispatcher port in asynchronous way . Any further instances of UAE-App (launched by the
  101.      default tool interface and the shell interface) send their arguments to the server, to be inserted in the
  102.      input stream.
  103.  
  104. Bugs-Warnings-Todo
  105.  
  106.      - No character translation in filenames yet (except slashes)
  107.      - Disk images are not locked yet when mounted
  108.  
  109. History
  110.  
  111.      990319 uae-app_012.lha first aminet release.
  112.      - added about window, button and menue.
  113.      - added status display line, displaying all operations in gui.
  114.      - fixed cx_popkey bug with CX V37 (cx_popkey installation now properly CX V38+).
  115.      - checks AMIGA-PATH for uae.device now, fails safe on hardfiles and real amigas.
  116.      - added pattern gadget to filerequesters, including adz and adf.gz files now.
  117.      - fixed filerequesters to work with v36+ os (oops, called v39 stuff before).
  118.      - added emulator menue to call softreset/hardreset/exitemu/debug.
  119.      - added Create function, creates blank 880K adf image.
  120.      - enhanced asynchronous GUI filename refresh.
  121.      990312 uae-app_011.lha first usable version.
  122.      - added appmenuitem.
  123.      - added prelimary shell argument handler.
  124.      - added ADF project icon default tool interface.
  125.      - added Project menue.
  126.      - simplified gui.
  127.      - added ASL filerequester.
  128.      - added skip button.
  129.      - added CX_POPKEY tooltype and function (defaults to ctrl alt u).
  130.      990306 uae-app_010.lha initial alpha release.
  131.  
  132. Legal Stuff
  133.  
  134.      (c) 1999 Ralf Steines aka Hippie2000, FREEWARE, must not be sold, may be
  135.      distributed as original archive by any medium, may be included as single files in any
  136.      UAE distribution, even commercial ones. PROVIDED "AS IS", NO WARRANTY
  137.      OF ANY KIND, USE AT YOUR OWN RISK....
  138.  
  139.  
  140.  
  141. Feedback Form
  142.  
  143.      It's impossible for me to test this program with all ports of UAE, so i need your
  144.      feedback to make it work best. Email to metamonk@yahoo.com or use the form
  145.      at http://metamonk.com/uae/ for feedback. Thanks.
  146.